bAjax - A tiny Ajax library written in JavaScript

About

bAjax is a tiny Ajax library which is written in JavaScript.
Able to run Ajax by just calling the function that resides in the library.
Able to work together with different server-side languages, such as PHP, ASP, JSP, etc.
Dealing with JSON, XML, Plain Text data format.
Cross-browsers, supported in: Internet Explorer (IE 6.0+), FireFox, Safari, Opera, Chrome.
Objectives:
1. To help and ease developers for writing Ajax.
2. Getting Ajax's result without writing much.
3. Save time and your code writing.

The Functions

bajax.init(option)

The core function to make Ajax lives in your application.
It's taking one argument, option, a key/value pairs in a curly brackets: { }, which will be sent for handling Ajax called.
To see full options, please refer to "The Options".

callback: function(result){}

A callback function that resides in the argument {}, which is sent to bajax.init(option)
Used for handling the returned data from the server.
The server's returned data will be passed to the function via argument, result.

bajax.serialized(formID)

Used for serializing form data.
It's in encoded name-value pairs format.
Format: name1=value1&name2=value2&name3=value3&nameN=valueN...
Call it by assigning the particular form's Id to argument, formID.

bajax.loader(tagID, loader)

To display Ajax loader in the specified HTML tag element, such as <span>, <div>, etc.
tagID, the Id of the element you want to display the loader;
loader, the string/<image> that you want it to be displayed.

bajax.clearLoader(tagID)

Simply call it once Ajax is done.
To clear the Ajax loader by assigning the Id to tagID

The Options

There are some options you will need to set in the argument when calling on bajax.init(option) function to make Ajax lives. The options are in the key/value pairs, which reside in a curly bracket {}. Here is the list:
id

Optional
Format: String
The Id that you might be using it for displaying the returned data from the server.

url

Mandatory
Format: String
The static or remote page that you're going to call for sending and processing data.

data

Optional
Format: String (serialized)
The data that will be sent to the server; *must* be in serialized format.
(name1=value1&name2=value2&name3=value3&nameN=valueN...)

method

Optional
Format: String
The method of sending data. Holds the "GET" or "POST" value. It's set as "GET" by default if not specified.

type

Optional
Format: String
Values:
"json" - get the returned JSON data from server
"xml" - get the returned XML data from server
If 'type' is not specified, plain text data format will be used as default.

callback

Mandatory
Format: Function
Taking one argument, result
Ajax will pass the processed data to this callback function. The returned data will be assigned to result argument. You can then proceed to dealing the processed data in order to meet your needs.

How bAjax Works

It's easy to use bAjax for calling Ajax. To do so, you will need to include "bajax.js" file in the first place (Normally within <head> </head> tag). Once you're done, just invoke this function: bajax.init(option)

The way to include "bajax.js" could be like so:
(make sure the path is correct and tally with your own application's directory)

The minimal condition for using this function is as follows:

bajax.init({ 
url: "my_ajax_action_page.php",
callback: function(result){ 
 /* 
   the processed data will be passed to "result" argument,
   do your works here, or even go further 
 */
}
});

This is the simplest way for using init function to get your Ajax's result. Once you have had the processed result in the callback function, you're allowed to do more and even proceed to your own JavaScript's functions.

Please refer to the "Demo" to see more usage of this function.